home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 120 (1989-11-15)(Ossowski, Stefan)(DE)(PD).zip / Taifun 120 (1989-11-15)(Ossowski, Stefan)(DE)(PD).adf / SuperLines / SuperLines.doc < prev    next >
Text File  |  1989-09-29  |  12KB  |  249 lines
  1. SuperLines - Everything you could ever want in a demo program
  2. -------------------------------------------------------------
  3. by Chris Bailey, version 1.0  15-Aug-89
  4.  
  5.   I guess the last thing that the Amiga World (no, not the magazine)
  6.   needed was another "lines" demo.  Well, sorry, I just HAD to try
  7.   my hand at writing one, and hopefully I came up with something
  8.   that will satisfy just about anybody.
  9.   
  10. Features:
  11. ---------
  12.   Can run on a screen of just about any depth/resolution
  13.   
  14.   Screen dimensions match your standard screen size for
  15.   MoreRows/PAL compatibility
  16.   
  17.   9 different built-in, selectable palettes
  18.   
  19.   Lines, Boxes, and Splines modes
  20.   
  21.   Real-Time "configuration" editor, changes are evident AS THEY HAPPEN
  22.   
  23.   Color cycling, friendly interface, and MUCH MUCH MORE
  24.   
  25. To Have Fun Fast:
  26. -----------------
  27.   Activate the program now, either via CLI or Workbench.  There are no
  28.   command line options or Workbench tooltypes, just load it and go!
  29.   Play around with the different options and when you get tired, come
  30.   back here and read how it all works.
  31.   
  32. Menu Items
  33. ----------
  34.  
  35.   The Control Panel - Amiga P
  36.   -----------------
  37.     When the program is up and running, you can select from four menu
  38.   items.  The first one is probably of the most interest, and is
  39.   entitled simply "Panel."  This is the heart of the SuperLines program,
  40.   and where you will probably be spending lots of time here.
  41.   
  42.     One thing you will notice once the Control Panel is open is that the
  43.   movement on the lines screen does not stop, but it keeps going.  This
  44.   way you can make changes using the control panel and see what your
  45.   changes are doing on the screen behind you.  This is REAL TIME.
  46.     There are disadvantages to having the Panel open.  It takes
  47.   up probably 2/3 of a Lo-Res screen, so you may have trouble seeing
  48.   the display while it's open on a Lo-Res screen.  To remedy this, use
  49.   the "Change Screen" option to change to something other than Lo-Res,
  50.   or close the panel.
  51.     Also, because of layers coming into play, the lines display will
  52.   run slower when this window is open.
  53.   
  54.     First of all, the three gadgets across the top of the window
  55.   control what "mode" SuperLines is in.  These are:
  56.   
  57.    ° Lines -  "Lines" should be obvious, as it is the mode that the
  58.    program comes up in.
  59.    
  60.    ° Boxes - works similar to "Lines" except that, what a surprise,
  61.    it draws boxes that are symmetric across the middle of the screen.
  62.    
  63.    (More modes may be added at a later date)
  64.  
  65.     And by the way, when you change modes the screen clears before
  66.   continuing.  If this were not done, the display would look pretty
  67.   bad within a few cycles.
  68.   
  69.     Down the left-hand side of the window are five options with selectable
  70.   boxes down the side.  The gadgets and their functions are:
  71.   
  72.    ° ColorBounce - Line colors normally run from 1 to the maximum number of
  73.    colors available under your current screen, causing a spread of
  74.    colors from 1 to max, and then starting over again.  If ColorBounce
  75.    is selected, when the color number reaches max, it will decrement
  76.    until it reaches 1 again and then bounce back up, so that the
  77.    line colors are "bouncing" back and forth between 1 and max.  This
  78.    is a good option to use if you have a smooth spread of colors
  79.    between 1 and max, but colors 1 and max don't match up.
  80.       
  81.    ° Fast Mode - SuperLines eats mucho processor time, but it is
  82.    faster than having this turned off.  When "fast" is on, it causes
  83.    SuperLines to go as fast as possible.  To see an example
  84.    of how fast this is, change SuperLines' screen to Hires,
  85.    Interlace, and 1 bitplane.  Then turn "Fast" mode on, close the
  86.    control panel, and give yourself a headache.  Even with "Fast" mode
  87.    off, however, SuperLines still takes a good bit of processor
  88.    time.  When not in "Fast" mode, SuperLines simply inserts a
  89.    delay of 1/50th of a second between each line it draws, which
  90.    alleviates a bit of processor time for better multitasking.
  91.    However, this is not a good program to run while, say, your
  92.    bulletin board is running and somebody is online.
  93.     
  94.    ° Color Smudge - This option, when turned on, causes SuperLines to
  95.    rotate all color registers through all of the colors of the Amiga
  96.    palette as the lines are drawn.  This works well on screens with
  97.    few bitplanes to give the appearance of more colors.
  98.     
  99.    ° Color Cycle - This is just simple color cycling, if you want
  100.    ranges and speeds, stick to DPaint.  Color Cycle will rotate
  101.    all of the colors in the palette once with every line drawn.
  102.     
  103.    ° Reverse - This option only has affect when Color Cycling is
  104.    turned on.  It will cause the colors to be rotated in the reverse
  105.    direction.
  106.       
  107.     On the right hand of the Panel, you will notice two sliders.  These
  108.   control the following:
  109.   
  110.    ° Range - This is the maximum distance between successive endpoints
  111.    of consecutive lines.  In layman's terms, it controls how far apart
  112.    each line will be from the one next to it.  Note that this only
  113.    controls the MAX, so even if you have this cranked up to 100, every
  114.    now and then you may find that the lines are getting close to each
  115.    other again, if only for an instant.  The program notices changes
  116.    from this instantly, however changes won't usually be noticeable
  117.    until the lines reach a screen boundary at least once after making
  118.    changes here.
  119.    
  120.    ° Lines - This is the maximum number of Lines (or boxes, etc) that
  121.    are displayed before they start being erased.  The higher this number
  122.    is, the more cluttered the screen will look.  You can even move this
  123.    down to 1, but it looks kind of weird to see just one line tumbling
  124.    around the screen.  To keep the display pretty, after changing this
  125.    value, the screen will clear.
  126.    
  127.     Across the bottom of the panel are nine gadgets numbered one through
  128.   nine.  These are pre-set palettes that you may wish to switch to
  129.   while playing with SuperLines.  Here are some general descriptions
  130.   of each of the palettes:
  131.    
  132.    ° Palette 1 - A rainbow spread between bright green, red, and blue
  133.    ° Palette 2 - A spread of RED hues
  134.    ° Palette 3 - A spread of GREEN hues
  135.    ° Palette 4 - A spread of BLUE hues
  136.    ° Palette 5 - A light colored background with dark colors
  137.    ° Palette 6 - Alternating light and dark colors for a "sparks" affect
  138.                  when used on an interlace screen with Cycle turned on
  139.    ° Palette 7 - A black and white palette, for those with b/w monitors
  140.    ° Palette 8 - A light colored background with dark, muted colors
  141.    ° Palette 9 - A dark background with very light colors
  142.  
  143.     These are all full palettes of 32 colors each, but most of them
  144.   will look okay on a 16 color screen (or less), although some of the
  145.   ranges may get disrupted on screens with less than 16 colors.
  146.     Also, you may want to turn off color cycling and color smudge before
  147.   changing to a new palette, although this is not required.
  148.  
  149.     Finally, when you are ready to exit the control panel, you can either
  150.   click on its close gadget, or press the same menu item (Amiga-P) that
  151.   you used to open the panel with.
  152.     Something else that is interesting - the Lines display runs much
  153.   faster when the Panel is not open.  This is not due to anything
  154.   in my program, but Intuition is having to save all of the information
  155.   behind the Panel while it is open.  Or any other window that might
  156.   happen to be open on my screen, for that matter.  For this reason,
  157.   SuperLines will run a bit faster without any other windows over its
  158.   display.
  159.     Don't worry about quitting or changing screen modes with the panel
  160.   up, it will remove itself for you before closing the screen.
  161.  
  162.   Change Screen - Amiga C
  163.   -------------
  164.     This option is used to change the display that SuperLines uses.
  165.   There are no fussy numbers to fool with or anything.  Just point
  166.   and click.  The window contains six gadgets.  These are:
  167.    
  168.    ° HiRes - Click on this to make your new screen selection a HiRes
  169.    screen.  If your depth is set to more than 4, it will reduce itself
  170.    automatically.
  171.    
  172.    ° Lace - Actually, Interlace.  Selecting this will make your new
  173.    screen interlaced.
  174.    
  175.    ° < and > - these gadgets raise and lower the depth setting for your
  176.    new screen.  Note that you can raise the depth to 6 if you have not
  177.    selected HiRes; this will make your new screen (ta-da!) an
  178.    ExtraHalfBrite screen and your lines will be drawn in all 64 of
  179.    the HalfBrite colors.  You may wish to change the "Lines" prop
  180.    gadget to at least 64 so you can see all of the colors onscreen
  181.    at once.
  182.    
  183.    ° Okay - This will confirm your changes.  If you are satisfied, press
  184.    this and the screen will fold up and re-form with the dimensions that
  185.    you requested.  The width and height of the screen will be based on
  186.    values in GfxBase, so your screen should take up the same space as
  187.    whatever your normal display size is.  Note that if the settings are
  188.    the same as the normal ones when you press OKAY, (for example, you
  189.    played with the gadgets and wound up where you started) nothing will
  190.    happen.  This avoids unnecessary screen openings/closings.
  191.  
  192.    ° Cancel - Forget any changes you might have made, and go back to
  193.    your previous settings.
  194.  
  195.     I believe I have made this part of the program as foolproof as
  196.   possible, and there should not be any way you can select "illegal"
  197.   screen values, so you can comfortably switch back and forth between 
  198.   as many modes as you like without having to question whether everything
  199.   is "Legal" before going on.
  200.     Note - if you switch to a mode that requires a display that takes
  201.   up more memory than you have, SuperLines _should_ exit politely.
  202.    
  203.   About - Amiga A
  204.   -----
  205.     This simply displays some information about the program, the author's
  206.   name, version number, date produced, and whatever else I happened to
  207.   put there at the last minute.  Click on the "Continue" gadget or press
  208.   "c" to remove the notice and get on with the program.
  209.   
  210.   Quit - Amiga Q
  211.   ----
  212.     This exits the program.  Before leaving, you will be asked if you
  213.   really want to leave.  Clicking the "yes" gadget will terminate the
  214.   program, and clicking the "no" gadget will cancel your intent
  215.   to leave.  You may also type "y" or "n" on the keyboard to respond.
  216.     Also note that you can click on the (invisible) close gadget in the
  217.   main window to exit.  Things will proceed in the same manner as if
  218.   you had chosen the menu item.
  219.   
  220. ------------------------------------------------------------------------
  221.     This program was developed using M2Sprint Modula-2 from M2S Inc.,
  222.   Dallas, Texas.  This is a very friendly, very powerful, very
  223.   feature-packed development environment.  If you are at all interested
  224.   in Modula-2, you should check out the competition and then check
  225.   out M2Sprint.  You won't be disappointed.
  226.   
  227.     There may or may not be revisions of this.  I would really like
  228.   to have Splines, and I have a palette routine ready to drop in.
  229.   I would also like to add some PolyDraw routines, so that PolyScope-
  230.   like effects would be possible.  If you have an idea, get in touch
  231.   with me, updates will depend on user comments.
  232.   
  233.     This program is freely distributable.  However, it may be included
  234.   on public domain collections that cost THE SAME AS THE
  235.   FISH DISKS OR LESS.  In other words, only on PD disks that charge
  236.   only for media and/or mailing compensation.  
  237.     Also, this may be uploaded to any network or bulletin board that 
  238.   claims no sort of copyright on material posted there.  
  239.   
  240.     To contact me:
  241.     
  242.     bix : csbailey (this is preferred)
  243.     
  244.     phone: (803) 794-4933
  245.     data : (803) 791-9448  (note - BBS down due to BBS-PC's idiocy)
  246.     mail : Chris Bailey
  247.            2405, Feather Run Trail
  248.            W. Columbia, SC  29169
  249.